home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / comm / bbs / FileTool.lha / FileTool.dok < prev   
Encoding:
Text File  |  1995-02-03  |  6.5 KB  |  193 lines
  1. AmBoS FileTool
  2. --------------
  3.  
  4. +----------------------------------------------+
  5. |                                              |
  6. |  Anmerkungen zur DEMO-Version des Programms  |
  7. |                                              |
  8. +----------------------------------------------+
  9. |                                              |
  10. | Diese Demo ermöglicht es, alle Funktionen    |
  11. | des File-Tools auszuprobieren. Es bestehen   |
  12. | folgende Einschränkungen:                    |
  13. |                                              |
  14. | - Bis auf die Funktion "FileName-ändern"     |
  15. |   haben die Aktionen innerhalb des FileTools |
  16. |   keinerlei Auswirkung auf den Brettinhalt.  |
  17. |   Es wird kein File gelöscht oder ein neuer  |
  18. |   Kommentar gespeichert.                     |
  19. |                                              |
  20. | - Eine vom Benutzer verschickte "Mahnung"    |
  21. |   erreicht nicht den Uploader des aktiven    |
  22. |   Files, sondern den Benutzer selbst.        |
  23. |                                              |
  24. |                                              |
  25. | Das "FileTool" ist Shareware und Bestandteil |
  26. | meines zweiten Paketes "AmBoS Tools!n!Games" |
  27. |                                              |
  28. | Mfg. Christian (eMail: automan@doom.gun.de)  |
  29. +----------------------------------------------+
  30.  
  31.  
  32. 1. Wozu dieses Programm?
  33. ------------------------
  34.  
  35. Die Grundidee zu diesem Programm war, einen "Faker" zu schreiben. Ein "Faker"
  36. ist ein Programm, welches es dem Sysop ermöglicht, einen User für das Uploaden
  37. z.B. eines defekten oder sehr alten Files zu "bestrafen", d.h. es kann ihm der
  38. dafür erhaltene Download-Freiraum wieder abgezogen werden....
  39.  
  40. Das "schlechte" File kann dann gelöscht und mit einem auffälligen "Fake-ANSI"
  41. versehen werden. Zusätzlich gibt es die Möglichkeit, eine vorgefertigte
  42. Nachricht an den Uploader zu senden und ihn über sein "schlechtes" Upload zu
  43. informieren...(dazu unten mehr).
  44.  
  45. Die Funktionen zum editieren des File-Kommentars können natürlich auch benutzt
  46. werden, ohne gleich ein File zu löschen...  Außerdem steht noch eine "Rename"-
  47. Funktion zum Ändern des Filenamens in der Box zur Verfügung.
  48.  
  49.  
  50. 2. Installation
  51. ---------------
  52.  
  53. Das Programm sollte sich wie alle anderen externen Programme für AmBoS im
  54. Verzeichnis
  55.  
  56.   "BBS:Externe/"
  57.  
  58. befinden. Dort wiederum ist ein eigenes Verzeichnis "FileTool" für
  59. das Programm anzulegen.
  60.  
  61. Dann muß das Programm nur noch vom AmBoS-Setup/Befehle aus angemeldet und
  62. aktiviert werden...
  63.  
  64.  
  65.  
  66. 3. Aufruf und Bedienung
  67. -----------------------
  68.  
  69. Das FileTool kann direkt aus dem Brettinhalt eines Binär- (oder Binär+ASCII)
  70. Brettes aufgerufen werden.
  71.  
  72. Die zu bearbeitenden Files müssen dann "markiert" (nicht gemerkt!) und das
  73. Programm über den Menüpunkt "Externe" aufgerufen werden.
  74.  
  75. Sind keine Files markiert, besteht auch die Möglichkeit, die Nummer der zu
  76. bearbeitenden Files einzugeben. Dabei sind Aufzählungen wie z.B. "1,3,5-10"
  77. erlaubt.
  78.  
  79. Nun wird das erste ausgewählte File übernommen und kann vom FileTool aus
  80. bearbeitet werden.
  81.  
  82. Es stehen folgende Funktionen zur Verfügung:
  83.  
  84.  
  85. 3.1 <F> Filename ändern
  86. -----------------------
  87.  
  88. Dies ist eine einfache "RENAME" Funktion, die es erlaubt den Namen des Files
  89. in der Mailbox (nicht auf der Festplatte) zu ändern.
  90.  
  91.  
  92. 3.2 <K> Kommentar editieren
  93. ---------------------------
  94.  
  95. Hier kann ein neuer File-Kommentar eingegeben werden. Zum Editieren können wie
  96. in einem normalen Texteditor auch die Cursor-Tasten verwendet werden. Der neue
  97. Kommentar wird gespeichert, sobald die letzte Zeile des Kommentarfeldes mit
  98. "RETURN" verlassen wurde.
  99.  
  100.  
  101. 3.3 <A> Auswahl eines Kommentares
  102. ---------------------------------
  103.  
  104. Mit diesem Menüpunkt kann ein vorher entworfener File-Kommentar geladen werden.
  105. Die vordefinieten Kommentare befinden sich in einem Textfile, welches unter
  106.  
  107.   "BBS:Externe/FileTool/Kommentar.lib"
  108.  
  109. gespeichert ist. Ein Kommentar belegt dort immer 8 Zeilen, auch wenn eine oder
  110. mehrere Zeilen nicht benutzt werden.
  111.  
  112. Mit einer beliebigen Taste kann zum jeweils nächsten Kommentar gewechselt
  113. werden. Die Taste "Q" beendet die Auswahl und es folgt eine Abfrage, ob der
  114. gewählte Kommentar gespeichert werden soll oder nicht.
  115.  
  116.  
  117. 3.4 <L> Löschen des Files
  118. -------------------------
  119.  
  120. Diese Funktion bitte mit Vorsicht gebrauchen! :-)
  121.  
  122. Das angezeigte File wird nach einer Sicherheitsabfrage von der Festplatte (!)
  123. gelöscht, in der Mailbox bleinbt es jedoch erhalten. Auf der Festplatte wird
  124. dann ein "Geister-File" (Länge 0 Bytes) erzeugt, damit der Mailbox-Eintrag
  125. nicht automatisch von AmBoS gelöscht wird und eine evtl. warnende Botschaft
  126. im Filekommentar für alle User zu sehen bleibt...:-).
  127.  
  128. Soll ein File entgültig gelöscht werden, ist dieses weiterhin nur von AmBoS
  129. direkt aus zu erledigen.
  130.  
  131. Nach dem eigentlichen Löschvorgang fragt das Programm, ob dem Uploader des
  132. Files die ihm dafür gutgeschriebenen Bytes wieder abgezogen werden sollen
  133. (vom Download-Freiraum). Dabei kann noch eine Faktor von 0-9 gewählt werden.
  134. Einige Informationen über die Upload- und Download-Aktivitäten des Uploaders
  135. werden außerdem noch auf den Bildschirm angezeigt.
  136.  
  137. Schließlich kann der Uploader noch von der ganzen Aktion durch eine Nachricht
  138. in seinem Postfach informiert werden. Wird diese Abfrage mit "Ja" bestätigt,
  139. muß zunächst ein Grund für die Löschung eingegeben werden. Die zu versendende
  140. Nachricht kann wiederum vom Sysop mit einem Texteditor verändert werden. Der
  141. Filename ist
  142.  
  143.   "BBS:Externe/FileTool/MailAnUser".
  144.  
  145. Dabei sind folgende "Variablen" erlaubt, die dann beim Versandt ersetzt werden:
  146.  
  147. @alt    = Download-Freiraum vor der Löschung
  148. @neu    = Download-Freiraum nach dem Abzug
  149. @Text   = Begründung des Sysops für die Löschung
  150. @User   = Username des Uploaders
  151. @mal    = Anzahl der Abzüge vom Download-Freiraum (wurde ... mal abgezogen)
  152. @File   = Filename des gelöschten Files
  153. @Brett  = Brettname
  154. @Länge  = Länge des gelöschten Files in Bytes
  155.  
  156. Weitere Variablen können jederzeit eingeführt werden, Anregungen sind immer
  157. willkommen....
  158.  
  159. 3.5 <U> User-daten
  160. ------------------
  161.  
  162. Diese Funktion zeigt die User-Daten des Uploaders an.
  163.  
  164.  
  165. 3.6 <E> Ende und <Q> Quit
  166. -------------------------
  167.  
  168. Diese beiden Funktionen beenden jeweils die Bearbeitung des angezeigten Files.
  169. Mit <E> kann zum nächsten markieten File gewechselt werden, <Q> dagegen
  170. verläßt das Programm ganz.
  171.  
  172.  
  173.  
  174. 4. Danksagung
  175. -------------
  176.  
  177. Vielen Dank an:
  178.  
  179. Klaro,Niere         - für die Testmöglichkeit in der
  180.                       "Chondrostoma Nasus AmboS BBS"
  181.  
  182. Coractor (Jens)     - für die ANSI-Unterstützung
  183.  
  184. Lemmy               - für die ANSI-Unterstützung
  185.  
  186. Jörch :-)           - für den AmBoS-Support
  187.  
  188. ---
  189.  
  190. Bremen, im Februar 1995
  191.  
  192.  
  193.